home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1994 December / SOFM_Dec1994.bin / mac / Desktop Publishing / Dejal Text Utilities / Dejal Text Utilities ƒ / About Dejal Text Utilities next >
Text File  |  1994-08-15  |  12KB  |  164 lines
  1.  
  2. Dejal Userware¬ presents
  3.  
  4. ╩
  5.  
  6.  
  7. Release 2, 15 August 1994.
  8.  
  9. TextSplitter¬ 2.0 copyright ⌐ 1994 by David Lambert.
  10. TextMerge¬ 2.0 copyright ⌐ 1993╨1994 by David Lambert.
  11. Dejal Text Utilities¬ package copyright ⌐ 1994 by David Lambert.
  12.  
  13.  
  14. Snail: Dejal Userware, PO Box 33-1011, Takapuna, Auckland 1309, NEW ZEALAND
  15. Internet & AOL: dejal@deepthought.kiwi.gen.nz  or  dejal@iconz.co.nz
  16. CompuServe: >INTERNET: dejal@deepthought.kiwi.gen.nz  or  100033,2435
  17.  
  18. I read the Internet mail every day, and will reply immediately (allow a couple of days for net.delay), but only call CI$ once a fortnight, or less.
  19.  
  20.  
  21. Shareware, US$20 for the package.
  22.  
  23.  
  24. ╤╤╤  Usage  ╤╤╤
  25.  
  26. The two applications in the Dejal Text Utilities package perform reverse operations of each other: TextSplitter allows you to split a text file into multiple parts, and TextMerge allows you to join several text files together.  They will both handle files of an unlimited length, and make efficient use of the available memory.
  27.  
  28. Both applications support Apple events: you can drop a file or files ╤ or even a folder full of files ╤ on either application, or start by simply double-clicking on the application icon.
  29.  
  30. Upon opening a file or files, a progress dialog will then appear, reporting the activity as it proceeds.  You may click the Stop button, choose Stop from the File menu, hit Escape, or Command-period to stop at any point, or choose Quit from the File menu to stop and leave.  When done, the progress dialog will be removed, and you will find the results of the process in the same location as the source file(s), unless otherwise specified.  The exact behaviour of the applications depends on the options of the current workset.
  31.  
  32.  
  33. Worksets:
  34.  
  35. The applications feature multiple worksets: the active workset affects how the files are processed, and may be chosen via the Worksets menu.  The applications come with a number of ready-made worksets, but you can also add your own, or modify or delete existing ones.  When you add a workset, the options start off the same as in the active workset, so that you can add one that is very similar to an existing one, but with a few differences.
  36.  
  37. The Worksets editing dialog features multiple ╥pages╙ of radio buttons, checkboxes, and entry fields, each page grouping certain kinds of functions.  You can switch between pages simply by choosing them from a popup menu.  The options in the Worksets dialog are different for each of the applications, though some items are in common, for example both applications have a Comments page, where you can make notes about the workset.  Here follows a description of the options for each application:
  38.  
  39. Ñ TextSplitter:
  40.  
  41. Split Text page:
  42.  
  43. This page lets you specify the text to search for when splitting; when this text is found, a new output file will be started.  You would type whatever text distinguishes one part of the file from another.  You can include Returns in the entry field: press Enter or click the OK button to accept the changes.  You can even include ╥Control╙ characters: simply type ╥^╙ (without the quotes) followed by an uppercase letter, e.g. ╥^L╙ to search for Control-L.  If you want to search for the sequence ╥^L╙ instead, prefix it with a bullet, e.g. ╥Ñ^L╙; the bullet will be ignored when searching.
  44.  
  45. If the prompt for split text radio button is selected, you will be asked via a dialog to provide the split text when opening a file (or the first file, if opening several at once).  If the following box is checked, your entry will be remembered for next time, otherwise the text you type into the Worksets dialog will be provided as the default each time.
  46.  
  47. The following radio buttons indicate whether the workset is intended as a general one, or whether to treat the text found following the split text as the date the message was received, for Berkeley or CompuServe format e-mail.
  48.  
  49. Berkeley format e-mail folders are used by the Pine and Elm e-mail programs, and possibly others, under unix; using TextSplitter you can download these folders (which are stored as single files) and retrieve the individual messages.
  50.  
  51. Include At page:
  52.  
  53. Here you can indicate whether to omit blank lines around the split text, and whether to include the split text at the start or end of the output files, or omit it altogether.
  54.  
  55. Folder page:
  56.  
  57. Here you can specify the suffix to add onto the names of the output folders (or leave it blank to have none), and indicate whether to include all of the output files in the same folder or separate folders; this only applies if you open more than one file at a time.
  58.  
  59. Filenames page:
  60.  
  61. Here you can indicate what filenames to use: if the files are e-mail messages, the output files can be named based on the ╥Subject:╙ header line of each message.  Since ╥:╙s are illegal in filenames, you can enter something to be used instead, if anything.  Alternatively, the filenames can be based on the name of the source file, or some fixed text.  Note that unique names are always created, in the same way as the Finder does, by adding numbers to the end until a unique name is found.
  62.  
  63. Dates page:
  64.  
  65. If the source file contains e-mail messages, you can indicate whether to use the dates that the messages were sent or received for the created and last modified dates of the output files.  Otherwise, you can choose whether to use the date the source file was created or last modifed, or simply use today╒s date (i.e. don╒t alter the output file dates).
  66.  
  67. Creator page:
  68.  
  69. Here you can indicate whether to use the same creator code as the source file, or specify a custom one.  You can even specify two different codes, based on the size of the output files; this feature was provided because some text editors (e.g. SimpleText and it╒s predecessor, TeachText) can only handle files up to 32K, whereas others don╒t have this limit, and you might want to use a different one in each case.  You can choose one of the applications from the popup menu, or type a code into the entry field.
  70.  
  71. Ñ TextMerge:
  72.  
  73. Separator page:
  74.  
  75. You can enter some text to place between each merged component of the file, e.g. a dashed line or a few blank lines.  As with the split text field in TextSplitter, you can type Returns into this field.  If you don╒t want to add anything, leave it empty.
  76.  
  77. Destination page:
  78.  
  79. This page features several choices for where to merge the text, basically grouped into three options that create a new output file, and three that append the text to an existing file.
  80.  
  81. The create in same place and append to first file options are the most trivial to use, as they simply use the same location as the source file, creating a new file next to the source file or appending to the first file opened, as appropriate.
  82.  
  83. The next options in each group allow you to use a standard file; they are useful if you wish to merge text into a specified file each time; you set the file once, and that is used thereafter.
  84.  
  85. The last two will prompt you for a destination each time, so you can decide on-the-fly.
  86.  
  87. Filename page:
  88.  
  89. Here you can specify a default filename to use ╤ this is used whenever prompting you for a file.
  90.  
  91. You can also specify what to base the name on, and a suffix to add to the filename to indicate that the file contains merged text.
  92.  
  93. File Info page:
  94.  
  95. Here you can specify whether to use the earliest created and most recent last modified dates for the output file, or simply use today╒s date (i.e. don╒t alter the dates).  The first option is useful to indicate the time-frame that the output file covers.  You can also set the creator code here; see the Creator page section of TextSplitter for a description.
  96.  
  97.  
  98. Preferences:
  99.  
  100. Both applications include a Preferences dialog, which allows you to configure common features:
  101.  
  102. Auto-Open If Nothing From the Finder:   If this is checked you will be automatically prompted with the Open file dialog when you launch the application by double-clicking it╒s icon (as opposed to dropping a file on it).  This option is off by default.
  103.  
  104. Present Open Dialog Until Cancel:   If checked, you╒ll be repeatedly prompted with the Open file dialog after processing a file until you Cancel the dialog.  This is off by default.
  105.  
  106. Auto-Quit When Done:   If checked, the application will automatically quit after successfully processing a file or files; it won╒t quit if you stop the operation, in case you wish to modify the Preferences or a workset.  This is off by default.
  107.  
  108. Animate Icons:   If checked, the icons in the progress dialog will be animated.  If you have a slow machine, you might experience a small speed improvement if you uncheck this option.  It is on by default.
  109.  
  110. Lock the Progress Dialog Position:   If checked, the progress dialog will always appear in the same location; if unchecked, whenever you move it the new position will be remembered for next time.  This is off by default (you might like to turn it on once you╒ve positioned the dialog in a favourite location).
  111.  
  112. Sort Worksets Alphabetically:   If checked, the worksets will be listed in alphabetical order in the Worksets menu (from the next time you run the application), otherwise they will be listed in the order they were added.  This is on by default.
  113.  
  114. Progress Bar Pattern:   Clicking this will cycle through the available patterns for the progress bar, so you can find one that you prefer.
  115.  
  116.  
  117. ╤╤╤  Dejal Sound Utilities¬  ╤╤╤
  118.  
  119. If you╒re into sounds, you may be interested in this popular bundle: SndConverter Pro¬, SndConverter Lite¬, SndPlayer¬, and SndCataloguer¬; four Shareware utilities that can be registered separately or together.  You╒ll find them on the Dejal Userware distribution disk and many online services, CD-ROM discs, etc.
  120.  
  121.  
  122. ╤╤╤  Compatibility  ╤╤╤
  123.  
  124. The Dejal Text Utilities applications require at least System 7, and are 32-bit compatible.
  125.  
  126. The usual disclaimers apply: David Lambert and Dejal Userware accept no responsibility for any incidental or consequential damage of any sort as a direct or indirect result of using this software.  The software is provided ╥as-is╙, and no warranties are made as to its fitness for a particular purpose or whatever.  I would be very interested to hear of any problems, though.  <grin>
  127.  
  128.  
  129. ╤╤╤  Release History  ╤╤╤
  130.  
  131. The following is a reverse-chronology of the changes in each release of the Dejal Text Utilities package:
  132.  
  133.  
  134. Release 2; TextSplitter 2.0 & TextMerge 2.0, 15 August 1994:
  135.  
  136. Ñ  Added support for multiple worksets.
  137. Ñ  Added the ability to open folders via Apple events or the Open dialog.
  138. Ñ  Added support for custom creator codes.
  139. Ñ  Added support for different creator codes based on the size of the output files.
  140. Ñ  Added the registration form printing option.
  141. Ñ  Added support for setting the created and modified dates of output files.
  142. Ñ  Added the ability to specify the default filename.
  143.  
  144. Features specific to TextSplitter 2.0:
  145.  
  146. Ñ  Added support for entering control character sequences in the split text.
  147. Ñ  Added recognition of ╥Subject:╙ and ╥Date:╙ header lines from e-mail.
  148. Ñ  Added the ability to include the split text at the start or end of the file, or omit it.
  149. Ñ  Added the ability to include all of the split files in the same folder.
  150.  
  151. Features specific to TextMerge 2.0:
  152.  
  153. Ñ  Added several different destination options.
  154. Ñ  Added the ability to include some text between each merged component.
  155.  
  156.  
  157. Release 1; TextSplitter 1.0 & TextMerge 1.1, 29 July 1994:
  158.  
  159. Ñ  First public release of the package.
  160.  
  161.  
  162. First started work on TextSplitter: 6 May 1994.
  163. First started work on TextMerge: 1 December 1992; version 1.0: 16 February 1993.
  164.